## 3.2. mSQL

The first step in installing mSQL is obtaining the source distribution. At the time of this writing, the newest versions of mSQL were only distributed through the Hughes Technology web page at http://www.Hughes.com.au. The author of mSQL has chosen not to officially distribute binary copies of mSQL. If you are on a machine without a C compiler, you will either have to install one, or compile mSQL on another machine with the same hardware and operating system and copy over the results.

Once you have the mSQL source distribution, unpack it using the following:

>     gunzip -c msql-2.0.4.1.tar.gz | tar xvf -

This will create a directory with the name `msql-2.0.4.1` within the current directory. Change to the new directory.

Create the installation directory for your machine by running the following command:

>     make target

Now change to the targets directory. Within this directory there should be a new directory with the name of your operating system and hardware (e.g., Solaris-2.6-Sparc or Linux-2.0.33-i386). Change to this new directory.

Run the `setup` script in the current directory. Make sure you invoke it as `./setup` so that the shell doesn't run any program named setup in another directory instead. This script will configure the source code for compilation. After this script has competed, examine the site.mm file and change any parameters you wish in order to customize your local installation. In particular, you may wish to change the `INST_DIR` variable that determines the directory where mSQL will be installed.

After you are satisfied with the configuration, run the following to compile mSQL:

>     make all

After compilation, the following command will install mSQL in the directory you have chosen:

>     make install

To summarize, a sequence of installation steps looks like this:

>     gzip -c msql-x.x.x.tar.gz | tar xvf -
>     cd msql-x.x.x
>     make target
>     cd targets/myOS-mymachine
>     ./setup
>     make all
>     make install

Copyright © 2001 O'Reilly & Associates. All rights reserved.